home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d14 / bckmn135.arc / BACKMENU.TXT < prev    next >
Text File  |  1991-02-06  |  7KB  |  214 lines
  1. Back-Menu V1.35
  2. ===============
  3.  
  4. Back-Menu is a program that allows you to define a pop-up menu on the
  5. Windows 3.0 background and use it to quickly run applications and tools.
  6. The idea came from using X-Windows and Sunview, where the user has a root
  7. menu that can be configured.
  8.  
  9. It allows you to describe a set of actions and associate command lines with
  10. them. To bring up the menu simply click with the mouse button (let, middle or
  11. right) on the Windows desktop. This will bring up the description list.
  12. Selecting a description will cause the appropriate command line to be executed.
  13.  
  14. There are six fixed options in the menu. The first five appear under the
  15. 'Back-Menu Options' walking menu. They are:-
  16.  
  17.     1) 'Reload Menu From File' - makes Back-Menu read its configuration
  18.        file again to update the menu contents.
  19.  
  20.         2) 'Execute...' - allows a command line to be typed and executed.
  21.  
  22.     3) 'Set Options...' - Brings up a dialog box from which you can
  23.        set the default start-up menu and which mouse button activates
  24.        the menu.
  25.  
  26.     4) 'About...' - speaks for itself.
  27.  
  28.     5) 'Remove Back-Menu' - un-installs the program. This option is
  29.        only present if you are not using Back-Menu as the shell.
  30.  
  31.     6) 'Exit Windows', which safely exits from Windows back to DOS.
  32.  
  33.  
  34.  
  35. Configuration Files
  36. ===================
  37.  
  38. By default, Back-Menu looks for a file called BACKMENU.INI in the same
  39. directory as BACKMENU.EXE. The menu file name can be changed by using
  40. the 'Set Options...' option.
  41.  
  42. A configuration file is simply a set of lines (one for each description/command
  43. line pair). The syntax for a menu item is:-
  44.  
  45.     Menu Item description,application,optional start-up dir
  46.  
  47. Blank lines may be placed between items, to cause a separator line to be
  48. placed in the menu.
  49.  
  50. Eg.                    Gives:
  51.                     +---------+
  52. Item 1,CMD1.EXE                | Item 1  |
  53.                     |---------|
  54. Item 2,CMD2.EXE FRED.TXT        | Item 2  |
  55. Notepad,NOTEPAD.EXE            | Notepad |
  56.                     +---------+
  57.  
  58.  
  59. This version of BACKMENU also supports cascading menus. A cascading menu item
  60. is one that has multiple options associated with it. By clicking on the item,
  61. another menu appears with the options on it. It is even possible to have further
  62. cascading menus associated with one or more items within that menu.
  63.  
  64. Associating multiple items with a single menu item is simple. The definition
  65. is:-
  66.     >Item Name
  67.         Sub menu item 1,program
  68.         Sub menu item 2,program
  69.         ...
  70.     !
  71.  
  72. That is, the sub-menu is enclosed between a '>' and a '!'. The text that follows
  73. the '>' is the text to appear in the menu (a description of the sub-menu).
  74.  
  75. In the example, 'Name' will appear in the menu, and when clicked upon produce a
  76. sub-menu with the items defined. Definining items within a sub-menu is done
  77. in exactly the same way as for a main menu (even to the extent of adding a
  78. sub-menu to this sub-menu). Eg:-
  79.  
  80.     >Editors
  81.         Andy's editor,AE.EXE
  82.         Notepad,NOTEPAD.EXE
  83.         >Word processors
  84.             Word for Windows,WORD.EXE
  85.             Windows Write,WRITE.EXE
  86.         !
  87.         Multi-Pad,MULTIPAD.EXE
  88.     !
  89.     ...
  90.  
  91. You are only limited to up to 15 items per sub-menu.
  92.  
  93.  
  94.  
  95. Start-Up Directory
  96. ==================
  97.  
  98. As of version 1.3, Back-Menu will change to the directory containing the
  99. executable program and then run it if a path is specified. Eg.
  100.  
  101.     Corel Draw,C:\CORELDRW\CORELDRW.EXE
  102.  
  103. will change to the directory C:\CORELDRW and then run CORELDRW.EXE. If no
  104. path is specified, the application will be started in the current directory
  105. (whatever that happens to be).
  106.  
  107. It is possible with Back-Menu to start up an application and set a different
  108. working directory for that program. To do this, specify the optional start
  109. up directory after the application. Eg. excel lives in c:\excel. We want to
  110. have excel start up in a work directory d:\data\excel. To do this, the menu
  111.  option would be:-
  112.     Excel + Work directory,c:\excel\excel.exe,d:\data\excel
  113.  
  114.  
  115.  
  116. Using Back-Menu as the Start-Up Shell
  117. =====================================
  118.  
  119. Back-Menu can now be used in place of Program Manager as the default shell
  120. for Windows. To install it simply edit SYSTEM.INI which is in the windows
  121. directory. In the [boot] section of the file there is a line which will
  122. read shell=progman.exe. Replace it with shell=backmenu.exe and you're away.
  123.  
  124.  
  125. Choice of Mouse Button
  126. ======================
  127.  
  128. The choice of which mouse button to use dramatically changes the way Back-Menu
  129. "feels". If the left mouse button is chosen, the menu pops-up when the button
  130. is pressed and disappears as soon as the button is released. With the right
  131. mouse button the menu remains on screen until a bottom-level seleection is
  132. made, regardless of how many times the left button is pressed.
  133.  
  134. Back-Menu also supports the middle mouse button. If you choose this and find
  135. that back-menu no longer functions then take the following steps:-
  136.  
  137.     1) Exit Windows (or reset if Back-Menu is installed as the shell).
  138.     2) Edit WIN.INI in the Windows directory.
  139.     3) Find the line which has [Back-Menu] on it. Below this there will
  140.        be a line Button=Middle. Change this to Button=Left or
  141.        Button=Right.
  142.  
  143.  
  144. Ambiguous File-Name Support
  145. ===========================
  146.  
  147. Back_menu now allows simple ambiguous file names as command line parameters
  148. to programs. If Back-Menu finds an ambiguous file name, it will prompt with
  149. a dialog box to let you choose. The path and filename are substituted in to
  150. the command line. If abort is chosen, the application is not started.
  151. Eg.
  152.     Word, C:\WORD\WINWORD.EXE *.doc
  153.  
  154. At the moment, paths cannnot be specified, and the command line may only
  155. contain the ambiguous file name.
  156.  
  157.  
  158. COMMAND LINE PARAMETERS
  159. =======================
  160.  
  161. It is possible to make Back-Menu prompt for a command line, which is then
  162. passed to the relevant program. To do this, place a % after the program
  163. name in the menu file. Eg.
  164.     Excel,c:\excel\excel.exe %
  165. Back-Menu will bring up a dialog box, which will allow the command line
  166. parameters to be typed.
  167.  
  168.  
  169. BUGS/FEATURES
  170. =============
  171.  
  172. V1.1    Fixed bug that prevented Back-Menu from being reloaded after it had
  173.     been removed.
  174.  
  175.     Restructured code so that it should work with EMS systems. (Not
  176.     tested fully).
  177.  
  178. V1.2    Added cascading menus.
  179.  
  180. V1.3
  181.     Locks up Compaq 386/25e sometimes when starting up DOS window.
  182.  
  183. V1.31
  184.     Added ambiguous file name support.
  185. V1.32
  186.     Made Back-Menu process the windows command line when it is the shell.
  187.  
  188. V1.33
  189.     Modified Open Dialog box to have dirs and files lists.
  190.     Fixed problem if you type in path and filename to opex dialog.
  191. V1.34
  192.     Added '%' to prompt for command line for an application.
  193.     Fixed bug where if you uninstall Back-Menu you get UAE.
  194.     Added about box.
  195.     Changed ambiguous filename support so that the open box has
  196.     the directory specified.
  197.  
  198. V1.35
  199.     Added support for setting start-up directory.
  200.     
  201. Any criticism/comments/praise/bugs etc can be directed to the author (me) as
  202.  
  203. Ian Heath
  204. Postgraduate Research
  205. University of Southampton
  206. England
  207.  
  208. mail:    ih@uk.ac.soton.ecs
  209. or:      ih@ecs.soton.ac.uk
  210.  
  211. (whichever you prefer).
  212.  
  213. This program is freeware. Share and enjoy!
  214.